Functions

The standard sound dialog component implements the following functions from the standard compression component interface. For more details, see the "Standard Image-Compression Dialog Components" chapter of Inside Macintosh: QuickTime Components.

SCGetInfo: This function supports all of the selectors documented in the "Constants" section. If an unsupported selector is used, it returns scTypeNotFoundErr .
SCSetInfo: This function supports all of the selectors documented in the "Constants" section. If an unsupported selector is used, it returns scTypeNotFoundErr .
SCRequestImageSettings: This function displays the sound settings dialog. If the user cancels the dialog box, the userCanceledErr is returned. To provide a filter procedure to process events while the dialog box is displayed, use SCSetInfo with the scExtendedProcsType selector.

SCGetSettingsAsAtomContainer

The SCGetSettingsAsAtomContainer routine retrieves the current configuration from the standard image-compression component.



 
pascal ComponentResult SCGetSettingsAsAtomContainer ( 

                     ComponentInstance  ci,

                     QTAtomContainer *settings);

ci: The standard compression component instance.
settings: The address where the newly-created atom container should be stored by the call.

DISCUSSION

The caller is responsible for disposing of the returned QT atom container.

SCSetSettingsFromAtomContainer

The SCSetSettingsFromAtomContainer routine sets the standard image-compression component's current configuration from the passed settings data.



 
pascal ComponentResult SCSetSettingsFromAtomContainer ( 

                     ComponentInstance  ci,

                     QTAtomContainer settings);

ci: Standard compression component instance.
settings: Contains a QT atom container reference to the settings.

DISCUSSION

The settings QT atom container may contain atoms other than those expected by the particular component type or may be missing certain atoms. The function will only use settings it understands.

| Previous | Chapter Contents | Chapter Top |